home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Enigma Amiga Life 112
/
EnigmaAmiga112CD.iso
/
dalla rivista
/
news
/
documentazione_flyer
/
flyerprivate.doc
< prev
Wrap
Text File
|
1999-05-18
|
20KB
|
1,168 lines
TABLE OF CONTENTS
flyer.library/AbortCmd
flyer.library/AudioParams
flyer.library/CacheTest
flyer.library/CheckCmd
flyer.library/CPUread
flyer.library/CPUwrite
flyer.library/DebugMode
flyer.library/DSPboot
flyer.library/FIRcustom
flyer.library/FIRinit
flyer.library/FIRmapRAM
flyer.library/FIRquery
flyer.library/FlyerChangeMode
flyer.library/FlyerCmpGrips
flyer.library/FlyerCopyGrip
flyer.library/FlyerExamine
flyer.library/FlyerFreeGrip
flyer.library/FlyerLoadVideo
flyer.library/FlyerLocate
flyer.library/FlyerOptions
flyer.library/FlyerParent
flyer.library/FlyerSCSIdirect
flyer.library/FlyerSelfTest
flyer.library/FlyerWriteProt
flyer.library/GetClrSeqError
flyer.library/PgmFPGA
flyer.library/ReadEEreg
flyer.library/RunModule
flyer.library/SBusRead
flyer.library/SBusWrite
flyer.library/SetClockGen
flyer.library/SetNoMode
flyer.library/SetPlayMode
flyer.library/SetRecMode
flyer.library/TeachFPGA
flyer.library/WriteEEreg
flyer.library/AbortCmd flyer.library/AbortCmd
NAME
AbortCmd -- abort a Flyer command then wait for completion
SYNOPSIS
error = AbortCmd(ID)
D0 D0
ULONG AbortCmd(ULONG);
FUNCTION
INPUTS
ID - returned from asyncronous command invocation
RESULT
error - result code
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/AudioParams flyer.library/AudioParams
NAME
AudioParams -- (not implemented)
SYNOPSIS
error = AudioParams()
D0
ULONG AudioParams(void);
FUNCTION
(nothing)
INPUTS
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/CacheTest flyer.library/CacheTest
NAME
CacheTest -- Test CPU caching of Flyer shared RAM
SYNOPSIS
error = CacheTest(board)
D0 D0
ULONG CacheTest(UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
RESULT
FERR_OKAY if alright, FERR_CMDFAILED if CPU is caching
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/CheckCmd flyer.library/CheckCmd
NAME
CheckCmd -- Check if a previously started command has completed
SYNOPSIS
error = CheckCmd(ID)
D0 D0
ULONG CheckCmd(ULONG);
FUNCTION
Checks if a previously started command is complete. If so,
wrap-up command entirely. If not, copyback any data that might
need updated.
INPUTS
ID - returned from asyncronous command invocation
RESULT
error - FERR_BUSY if not done, else result code
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/CPUread flyer.library/CPUread
NAME
CpuRead -- Read data word from Flyer's memory space
SYNOPSIS
error = CPUread(board,addr,dataptr)
D0 D0 A0 A1
ULONG CPUread(UBYTE,ULONG,UWORD *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - memory address (in Flyer memory space)
dataptr - pointer to variable to receive data read
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/CPUwrite flyer.library/CPUwrite
NAME
CpuWrite -- Write data to Flyer's memory space
SYNOPSIS
error = CPUwrite(board,addr,data)
D0 D0 A0 D1
ULONG CPUwrite(UBYTE,ULONG,UWORD);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - memory address (in Flyer memory space)
data - data to write
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/DebugMode flyer.library/DebugMode
NAME
DebugMode -- Set Flyer Debug modes
SYNOPSIS
error = DebugMode(board,flags)
D0 D0 D1
ULONG DebugMode(UBYTE,ULONG);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
flags - new debugging flags (32)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/DSPboot flyer.library/DSPboot
NAME
DSPboot - Download and run DSP program
SYNOPSIS
error = DSPboot(board,length,data)
D0 D0 D1 A0
ULONG DSPboot(UBYTE,ULONG,APTR);
FUNCTION
Downloads supplied program into the DSP and executes it.
INPUTS
board - specifies the Flyer board (0-3)
length - length of data provided
data - pointer to DSP program
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FIRcustom flyer.library/FIRcustom
NAME
FIRcustom - Define custom FIR coefficients
SYNOPSIS
error = FIRcustom(board,prepost,scale,data)
D0 D0 D1 D2 A0
ULONG FIRcustom(UBYTE,UBYTE,UWORD,UWORD *);
FUNCTION
Defines custom FIR filter coefficients (either for pre-compensation
or post-compensation). Each set contains 8 coefficients each. A FIR
coefficient is a signed 10 bit number extended to a WORD.
INPUTS
board - specifies the Flyer board (0-3)
prepost - determines which type of set is specified:
0 - pre-compensation (recording)
1 - post-compensation (playback)
scale - power-of-2 scaler value
data - pointer to 8 consecutive WORDs
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FIRinit flyer.library/FIRinit
NAME
FIRinit - Initialize FIR filter
SYNOPSIS
error = FIRinit(board,ctrl0,ctrl1)
D0 D0 D1 D2
ULONG FIRinit(UBYTE,UWORD,UWORD);
FUNCTION
Initializes the FIR filter chip using the parameters provided.
INPUTS
board - specifies the Flyer board (0-3)
ctrl0,ctrl1 - chip specific register values
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FIRmapRAM flyer.library/FIRmapRAM
NAME
FIRmapRAM - Setup FIR map RAM
SYNOPSIS
error = FIRmapRAM(board,bank,scale,shape)
D0 D0 D1 D2 D3
ULONG FIRmapRAM(UBYTE,UBYTE,UBYTE,UBYTE);
FUNCTION
Loads the FIR filter's map RAM with the correct table
INPUTS
board - specifies the Flyer board (0-3)
bank - FIR coefficient bank to load (0-7)
scale - power-of-2 scaler (1,2,4)
shape - 0 for linear, 2 for inverse sin
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FIRquery flyer.library/FIRquery
NAME
FIRquery -- Read out FIR coefficient/scale presets
SYNOPSIS
error = FIRquery(board,coefset,prepost,scaleptr,coefbuff)
D0 D0 D1 D2 A0 A1
ULONG FIRquery(UBYTE,UBYTE,UBYTE,UWORD *,UWORD *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
coefset - which set to read (0 - 31)
prepost - (0=pre, 1=post)
scaleptr - pointer to variable to receive scale value
coefbuff - pointer to buffer to receive 8 coefficient words
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerChangeMode flyer.library/FlyerChangeMode
NAME
FlyerChangeMode -- change access mode of grip object
SYNOPSIS
error = FlyerChangeMode(flyervolume,grip,access)
D0 A0 D0 D1
ULONG FlyerChangeMode(struct FlyerVolume *,ULONG,UBYTE);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive and path/name
of file
grip - grip of file/dir
access - new access mode
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerCmpGrips flyer.library/FlyerCmpGrips
NAME
FlyerCmpGrips -- compare the similarity of two grips
SYNOPSIS
error = FlyerCmpGrips(flyervolume,grip1,grip2)
D0 A0 D0 D1
ULONG FlyerCmpGrips(struct FlyerVolume *,ULONG,ULONG);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive
grip1 - first grip
grip2 - second grip
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerCopyGrip flyer.library/FlyerCopyGrip
NAME
FlyerCopyGrip -- make a clone of a grip
SYNOPSIS
error = FlyerCopyGrip(flyervolume,grip,gripptr)
D0 A0 D0 A1
ULONG FlyerCopyGrip(struct FlyerVolume *,ULONG,ULONG *);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive
grip - grip to copy
gripptr - pointer to variable to receive copied grip
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerExamine flyer.library/FlyerExamine
NAME
FlyerExamine -- return information about a file or directory
SYNOPSIS
error = FlyerExamine(flyervolume,grip,objinfoptr)
D0 A0 D0 A1
ULONG FlyerExamine(struct FlyerVolume *,ULONG,struct ClipInfo *);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive
grip - grip of file/dir
objinfoptr - Pointer to ClipInfo structure to receive info
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerFreeGrip flyer.library/FlyerFreeGrip
NAME
FlyerFreeGrip -- free a grip obtained earlier
SYNOPSIS
error = FlyerFreeGrip(flyervolume,grip)
D0 A0 D0
ULONG FlyerFreeGrip(struct FlyerVolume *,ULONG);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive
grip - grip to free
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerLoadVideo flyer.library/FlyerLoadVideo
NAME
FlyerLoadVideo -- force video data into output buffer
SYNOPSIS
error = FlyerLoadVideo(board,addr,size)
D0 D0 A0 D1
ULONG FlyerLoadVideo(UBYTE,APTR,ULONG);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - pointer to video data to load
size - size of data (in bytes)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerLocate flyer.library/FlyerLocate
NAME
FlyerLocate -- obtain a "grip" on a file/dir, from a grip/name spec
SYNOPSIS
error = FlyerLocate(clipaction)
D0 A0
ULONG FlyerLocate(struct ClipAction *);
FUNCTION
INPUTS
clipaction - specifies the path/name of the file
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerOptions flyer.library/FlyerOptions
NAME
FlyerOptions -- Get/Set Flyer option flags
SYNOPSIS
error = FlyerOptions(board,setflag,options)
D0 D0 D1 A0
ULONG FlyerOptions(UBYTE,UBYTE,ULONG *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
setflag - 0=read flags, 1=set flags
options - pointer to variable which contains options flags (for
both testing and setting)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerParent flyer.library/FlyerParent
NAME
FlyerParent -- get a grip on the parent of the grip/file specified
SYNOPSIS
error = FlyerParent(flyervolume,grip,newgripptr,blockptr)
D0 A0 D0 A1 A2
ULONG FlyerParent(struct FlyerVolume *,ULONG,ULONG *,ULONG *);
FUNCTION
INPUTS
volume - pointer to structure which specifies drive
grip1 - grip of file/dir
newgripptr - pointer to variable to receive the grip on the parent
blockptr - pointer to var to receive block which identifies parent
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerSCSIdirect flyer.library/FlyerSCSIdirect
NAME
FlyerSCSIdirect -- standard "SCSI direct" channel to Flyer drives
SYNOPSIS
error = FlyerSCSIdirect(board,unit,scsiinfo,structlen)
D0 D0 D1 A0 D2
ULONG FlyerSCSIdirect(UBYTE,UBYTE,struct SCSICmd *,UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
unit - SCSI unit number
scsiinfo - pointer to SCSICmd structure
structlen - length of SCSICmd structure provided
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerSelfTest flyer.library/FlyerSelfTest
NAME
FlyerSelfTest -- Run Flyer self-test tool
SYNOPSIS
error = FlyerSelfTest(board,test,arg1,arg2,result)
D0 D0 D1 D2 D3 A0
ULONG FlyerSelfTest(UBYTE,UBYTE,ULONG,ULONG,ULONG *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
test - test code to perform
arg1 - first arg for test
arg2 - second arg for test
result - pointer to variable to receive test results
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/FlyerWriteProt flyer.library/FlyerWriteProt
NAME
FlyerWriteProt -- set/test write protect status of drive
SYNOPSIS
error = FlyerWriteProt(flyervolume,setval,setflag,checkvalptr)
D0 A0 D0 D1 A1
ULONG FlyerWriteProt(struct FlyerVolume *,UBYTE,UBYTE,UBYTE *);
FUNCTION
This function can be used to test or set the write-protect status of
a Flyer drive. The drive is specified using a volume name or
SCSIdrive value in the volume structure.
A state of 0 means "write-enabled", 1 means "write-protected"
INPUTS
volume - pointer to structure which specifies drive and path/name of
file
setval - value to use (if 'setflag' is true)
setflag - 0=test state, 1=set state (to 'setval')
checkvalptr - pointer to variable to receive protect state if just
testing
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/GetClrSeqError flyer.library/GetClrSeqError
NAME
GetClrSeqErr -- Check or clear Flyer sequencing error register
SYNOPSIS
error = GetClrSeqError(board,flag,doneptr,userIDptr,moreinfoptr)
D0 D0 D1 A0 A1 A2
ULONG GetClrSeqError(UBYTE,UBYTE,UBYTE *,ULONG *,ULONG *);
FUNCTION
This is primarily used to check for timing errors during
sequencing. It is capable of returning the exact event that
failed to sequence, and an argument that gives detailed info
about the returned error.
This function takes very little time to execute, and does not
involve the Flyer CPU at all, so sequencing performance is not
affected.
INPUTS
board - specifies the Flyer board (0-3)
flag - 0=get error, 1=clear error
doneptr - pointer to a variable to receive the "done" status
(0 = still playing/recording, 1 = done)
userIDptr - pointer to a variable to receive the userID of the
event in the sequence that failed. This number is
private to the application that downloaded the
sequence. Set to NULL to not use this feature.
moreinfoptr - pointer to a variable to receive details about the
error, if any. This may be used to give the exact
number of fields an event was late, or how many fields
were dropped, for example. Set to NULL if not used.
RESULT
EXAMPLE
NOTES
Certain Flyer functions may clear this error, such as PlaySequence
and FlyerRecord.
On a "get" operation, always updates variables to whom pointers are
provided, regardless of the type of error code returned (or none)
BUGS
SEE ALSO
flyer.library/PgmFPGA flyer.library/PgmFPGA
NAME
PgmFPGA - Download and program one of the Flyer's FPGA chips.
SYNOPSIS
error = PgmFPGA(board,chip,length,data,rev)
D0 D0 D1 D2 A0 D3
ULONG PgmFPGA(UBYTE,UBYTE,ULONG,APTR,UBYTE);
FUNCTION
Downloads binary chip data and programs the selected FPGA. If the
chip fails to program properly, it is reset and this command returns
FERR_CMDFAILED.
INPUTS
board - specifies the Flyer board (0-3)
chip - Flyer chip number:
1 - Skew
2 - Timer/Router
3 - Pcoder 1
4 - Pcoder 2
5 - Mcoder 1
6 - Mcoder 2
7 - DMA controller
8 - Audio DMA interface
9 - Aligner
length - length of data provided
data - pointer to binary data
revision - rev code for chip file
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/ReadEEreg flyer.library/ReadEEreg
NAME
ReadEEreg -- Read from Flyer's EEPROM
SYNOPSIS
error = ReadEEreg(board,addr,dataptr)
D0 D0 D1 A0
ULONG ReadEEreg(UBYTE,UBYTE,UWORD *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - address in EEPROM (0 - 63)
dataptr - pointer to variable to receive data word read from EEPROM
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/RunModule flyer.library/RunModule
NAME
RunModule -- load/call supplied software module on Flyer processor
SYNOPSIS
error = RunModule(board,length,data,ID,argc,argv)
D0 D0 D1 A0 A1 D2 A2
ULONG RunModule(UBYTE,ULONG,APTR,ULONG *,UWORD,ULONG *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
length - length of code module in bytes
data - pointer to code module data
ID - returned from asyncronous command invocation (or 0 for sync)
argc - number of arguments supplied
argv - pointer to first argument supplied
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SBusRead flyer.library/SBusRead
NAME
SBusRead -- Read data from Flyer's internal fast sbus
SYNOPSIS
error = SBusRead(board,addr,dataptr)
D0 D0 D1 A0
ULONG SBusRead(UBYTE,UBYTE,UBYTE *);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - sbus address
dataptr - pointer to variable to receive data
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SBusWrite flyer.library/SBusWrite
NAME
SBusWrite -- Write data to Flyer's internal fast sbus
SYNOPSIS
error = SBusWrite(board,addr,data)
D0 D0 D1 D2
ULONG SBusWrite(UBYTE,UBYTE,UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - sbus address
data - data to write
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SetClockGen flyer.library/SetClockGen
NAME
SetClockGen -- Set speed of 1 of the Flyer's 4 clock generators
SYNOPSIS
error = SetClockGen(board,clock,speed)
D0 D0 D1 D2
ULONG SetClockGen(UBYTE,UBYTE,ULONG);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
clock - code for which clock to set
speed - desired clock speed (in Hz)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SetNoMode flyer.library/SetNoMode
NAME
SetNoMode -- Put Flyer in no play/record mode
SYNOPSIS
error = SetNoMode(board)
D0 D0
ULONG SetNoMode(UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SetPlayMode flyer.library/SetPlayMode
NAME
SetPlayMode -- Put Flyer in playback mode
SYNOPSIS
error = SetPlayMode(board)
D0 D0
ULONG SetPlayMode(UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/SetRecMode flyer.library/SetRecMode
NAME
SetRecMode -- Put Flyer in record mode
SYNOPSIS
error = SetRecMode(board)
D0 D0
ULONG SetRecMode(UBYTE);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/TeachFPGA flyer.library/TeachFPGA
NAME
TeachFPGA -- Teach flyer.library an FPGA chip definition
SYNOPSIS
error = TeachFPGA(chip,length,data)
D0 D0 D1 D2
ULONG TeachFPGA(UBYTE,ULONG,APTR);
FUNCTION
INPUTS
chip - chip number to define
length - length of definition in bytes
data - pointer to chip definition data
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO
flyer.library/WriteEEreg flyer.library/WriteEEreg
NAME
WriteEEreg -- Write into Flyer's EEPROM
SYNOPSIS
error = WriteEEreg(board,addr,data)
D0 D0 D1 D2
ULONG WriteEEreg(UBYTE,UBYTE,UWORD);
FUNCTION
INPUTS
board - specifies the Flyer board (0-3)
addr - address in EEPROM (0 - 63)
data - data word to write
RESULT
EXAMPLE
NOTES
BUGS
SEE ALSO